home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 1.iso / toolbox / documents / OpenGL / extensions / man / glcopytexsubimage2dext.z / glcopytexsubimage2dext
Encoding:
Text File  |  1996-11-11  |  11.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT((((3333GGGG))))     OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee     ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT - copy pixels into a 2D texture subimage
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT( GLenum _t_a_r_g_e_t,
  14.                                   GLint _l_e_v_e_l,
  15.                                   GLint _x_o_f_f_s_e_t,
  16.                                   GLint _y_o_f_f_s_e_t,
  17.                                   GLint _x,
  18.                                   GLint _y,
  19.                                   GLsizei _w_i_d_t_h,
  20.                                   GLsizei _h_e_i_g_h_t )
  21.  
  22.  
  23. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  24.      _t_a_r_g_e_t   The target texture.  Must be GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD or
  25.               GGGGLLLL____DDDDEEEETTTTAAAAIIIILLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD____SSSSGGGGIIIISSSS.
  26.  
  27.      _l_e_v_e_l    The level-of-detail number.  Level 0 is the base image level.
  28.               Level _n is the _nth mipmap reduction image.
  29.  
  30.      _x_o_f_f_s_e_t  A texel offset in the x direction within the texture array.
  31.  
  32.      _y_o_f_f_s_e_t  A texel offset in the y direction within the texture array.
  33.  
  34.      _x        The x coordinate of the lower-left corner of the pixel rectangle
  35.               to be transferred to the texture array.
  36.  
  37.      _y        The y coordinate of the lower-left corner of the pixel rectangle
  38.               to be transferred to the texture array.
  39.  
  40.      _w_i_d_t_h    The width of the texture subimage.
  41.  
  42.      _h_e_i_g_h_t   The height of the texture subimage.
  43.  
  44. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  45.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT replaces a rectangular portion of a two-
  46.      dimensional texture image with pixels from the current GGGGLLLL____RRRREEEEAAAADDDD____BBBBUUUUFFFFFFFFEEEERRRR
  47.      (rather than from main memory, as is the case for ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT).
  48.  
  49.      The screen-aligned pixel rectangle with lower-left corner at (_x, _y)
  50.      having width _w_i_d_t_h and height _h_e_i_g_h_t replaces the portion of the texture
  51.      array with x indices _x_o_f_f_s_e_t through _x_o_f_f_s_e_t+_w_i_d_t_h-1, inclusive, and y
  52.      indices _y_o_f_f_s_e_t through _y_o_f_f_s_e_t+_h_e_i_g_h_t-1, inclusive, at the mipmap level
  53.      specified by _l_e_v_e_l.  (But see the paragraph about GGGGLLLL____IIIINNNNTTTTEEEERRRRLLLLAAAACCCCEEEE____SSSSGGGGIIIIXXXX
  54.      below).
  55.  
  56.      The pixels in the rectangle are processed exactly as if ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss had
  57.      been called, but the process stops just before final conversion.  At this
  58.      point all pixel component values are clamped to the range [0, 1] and then
  59.      converted to the texture's internal format for storage in the texel
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT((((3333GGGG))))     OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee     ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      array.
  75.  
  76.      The destination rectangle in the texture array may not include any texels
  77.      outside the texture array as it was originally specified.  It is not an
  78.      error to specify a subtexture with zero width or height, but such a
  79.      specification has no effect.
  80.  
  81.      If any of the pixels within the specified rectangle of the current
  82.      GGGGLLLL____RRRREEEEAAAADDDD____BBBBUUUUFFFFFFFFEEEERRRR are outside the read window associated with the current
  83.      rendering context, then the values obtained for those pixels are
  84.      undefined.
  85.  
  86.      When GGGGLLLL____IIIINNNNTTTTEEEERRRRLLLLAAAACCCCEEEE____SSSSGGGGIIIIXXXX is enabled, successive rows of source pixels are
  87.      written to every other row in the texture subimage, rather than to every
  88.      successive row.  That is, row _j or the source image is written to row
  89.      _y_o_f_f_s_e_t+2_j of the destination texture, while rows
  90.      (_y_o_f_f_s_e_t+1,_y_o_f_f_s_e_t+3,...) are not modified.  A complete video frame may
  91.      be assembled in texture memory by invoking ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT on two
  92.      consecutive video fields, with _y_o_f_f_s_e_t values that differ by one.
  93.  
  94. NNNNOOOOTTTTEEEESSSS
  95.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT is part of the EEEEXXXXTTTT____ccccooooppppyyyy____tttteeeexxxxttttuuuurrrreeee extension, and
  96.      GGGGLLLL____IIIINNNNTTTTEEEERRRRLLLLAAAACCCCEEEE____SSSSGGGGIIIIXXXX is part of the SSSSGGGGIIIIXXXX____iiiinnnntttteeeerrrrllllaaaacccceeee extension.  See ggggllllIIIInnnnttttrrrroooo
  97.      for more information about using extensions.
  98.  
  99. EEEERRRRRRRROOOORRRRSSSS
  100.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated when _t_a_r_g_e_t is not one of the allowable
  101.      values.
  102.  
  103.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _l_e_v_e_l is less than zero or greater than
  104.      log2(_m_a_x), where _m_a_x is the returned value of GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE.
  105.  
  106.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _x_o_f_f_s_e_t<-TEXTURE_BORDER,
  107.      (_x_o_f_f_s_e_t+_w_i_d_t_h)>(TEXTURE_WIDTH-TEXTURE_BORDER), _y_o_f_f_s_e_t<-TEXTURE_BORDER,
  108.      or (_y_o_f_f_s_e_t+_i_n_t_e_r_l_a_c_ex_h_e_i_g_h_t)>(TEXTURE_HEIGHT-TEXTURE_BORDER).  Where
  109.      TEXTURE_WIDTH, TEXTURE_HEIGHT, and TEXTURE_BORDER are the state values of
  110.      the texture image being modified, and _i_n_t_e_r_l_a_c_e is 1 if GGGGLLLL____IIIINNNNTTTTEEEERRRRLLLLAAAACCCCEEEE____SSSSGGGGIIIIXXXX
  111.      is disabled and 2 otherwise.  Note that TEXTURE_WIDTH and TEXTURE_HEIGHT
  112.      include twice the border width.
  113.  
  114.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _w_i_d_t_h or _h_e_i_g_h_t is negative.
  115.  
  116.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated when the texture array has not been
  117.      defined by a previous ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD (or equivalent) operation.
  118.  
  119.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT is executed
  120.      between the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of
  121.      ggggllllEEEEnnnndddd.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT((((3333GGGG))))     OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee     ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT((((3333GGGG))))
  137.  
  138.  
  139.  
  140. ASSOCIATED GETS
  141.      ggggllllGGGGeeeettttTTTTeeeexxxxIIIImmmmaaaaggggeeee
  142.  
  143.  
  144. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  145.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT is supported only on RealityEngine,
  146.      RealityEngine2, and VTX systems.  On these systems:
  147.  
  148.           1. Only level 0 is supported; other levels result in a
  149.              GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE error.
  150.  
  151.           2. The texel offsets and the dimensions of the subimage must be
  152.              multiples of 32; otherwise a GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE error is generated.
  153.  
  154.           3. If ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT is used when a GLX video source is the
  155.              read drawable (see ggggllllMMMMaaaakkkkeeeeCCCCuuuurrrrrrrreeeennnnttttRRRReeeeaaaaddddSSSSGGGGIIII), _x_o_f_f_s_e_t and _y_o_f_f_s_e_t
  156.              must be 0 and _w_i_d_t_h must be 768; otherwise a GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE
  157.              error is generated.
  158.  
  159.           4. GGGGLLLL____IIIINNNNTTTTEEEERRRRLLLLAAAACCCCEEEE____SSSSGGGGIIIIXXXX is not supported (see ggggllllEEEEnnnnaaaabbbblllleeee).
  160.  
  161.  
  162. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  163.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT, ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss.
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.